﻿<html DIR="LTR" xmlns:tool="http://www.microsoft.com/tooltip" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ddue="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
  <head>
    <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=utf-8" />
    <META NAME="save" CONTENT="history" />
    <META NAME="BuildDateTime" CONTENT="2009-05-31 22:24:19" />
    <META NAME="BuildVersion" CONTENT="8.0.9151.2202" />
    <title>Microsoft Exchange Web Services Managed API Release Candidate Readme</title>
    
 <Style TYPE="text/css">

body
{
    background: #FFFFFF;
    color: #000000;
    font-family:    Verdana;
    font-size: medium;
    font-style: normal;
    font-weight: normal;
    margin-top: 0;
    margin-bottom:  0;
    margin-left:    0;
    margin-right:   0;
    width:  100%;
}

div.#mainSection
{
    font-size: 70%;
    width: 100%;
    padding-left:    10;
    margin-right: 10;
}

div.#mainBody
{
    font-size: 90%;
    margin-top: 10;
    padding-bottom: 20;
}

div.#header
{
    background-color: #D2D2D2;
    padding-top:    0;
    padding-bottom: 0;
    padding-left:   10;
    padding-right:  0;
    width:          100%;
}

div.#header table
{
    border-bottom-color: #C8CDDE;
    border-bottom-style: solid;
    border-bottom-width: 1;
    width:  100%;
}

span.#runningHeaderText
{
    color: #003399;
    font-size: 90%;
}

span.#nsrTitle
{
/*    color: #003399;*/
    font-size: 120%;
    font-weight: 600;
}

div.#header table td
{
    color: #000000;
    font-size: 70%;
    margin-top: 0;
    margin-bottom:  0;
    padding-right: 20;
}

div.#header table tr.#headerTableRow3 td
{
    padding-bottom: 2;
    padding-top: 5;
}

div.#header table.#bottomTable
{
    border-top-color: #FFFFFF;
    border-top-style: solid;
    border-top-width: 1;
    text-align: left;
}

div.#footer
{
    font-size: 90%;
    margin-top: 0;
    margin-bottom:  0;
    margin-left:    -5;
    margin-right:   0;
    padding-top:    2;
    padding-bottom: 2;
    padding-left:   0;
    padding-right:  0;
    width:  100%;
}

hr.#footerHR
{
    border-bottom-color: #EEEEFF;
    border-bottom-style: solid;
    border-bottom-width: 1;
    border-top-color: C8CDDE;
    border-top-style: solid;
    border-top-width: 1;
    height: 3;
    color: #D2D2D2;
}

div.section
{
    padding-top:    2;
    padding-bottom: 2;
    padding-right:  15;
    width:  100%;
}

.heading
{
    color:          #000000;
    font-weight:    bold;
    margin-top:     18;
    margin-bottom:  8;
}

h1.heading
{
    color: #000000;
    font-size:  150%;
}

.subHeading
{
    color:          #000000;
    font-weight:    bold;
    font-size:      150%;
    margin-bottom:  4;
}

h2.subHeading
{
    color:          #000000;
    font-weight:    bold;
    font-size:      130%;
}
h3.subHeading
{
    color:  #000000;
    font-size: 125%;
    font-weight: bold;
}

h4.subHeading
{
    color: #000000;
    font-size: 110%;
    font-weight: bold;
}

h4.procedureHeading
{
    color: #000080;
    font-size: 110%;
    font-weight: bold;
}

h5.subHeading
{
    color: #000000;
    font-size: 100%;
    font-weight: bold;
}

img
{
    padding-bottom: 10;
}

img.toggle
{
    border: 0;
    margin-right: 5;
    padding-bottom: 10;
}

img.copyCodeImage
{
    border: 0;
    margin: 1;
    margin-right: 3;
    padding-bottom: 10;
}

img.downloadCodeImage
{
    border: 0;
    margin-right: 3;
    padding-bottom: 10;
}

img.viewCodeImage
{
    border: 0;
    margin-right: 3;
    padding-bottom: 10;
}

img.note
{
    border: 0;
    margin-right: 3;
    padding-bottom: 10;
}

img.#membersOptionsFilterImage
{
    border: 0;
    margin-left: 10;
    vertical-align: middle;
    padding-bottom: 10;
}

img.#toggleAllImage
{
    margin-left: 4;
    vertical-align: middle;
    padding-bottom: 10;
}

div.#mainSection table
{
    border: 0;
    font-size: 100%;
    width:  100%;
    margin-top: 5px;
    margin-bottom: 15px;
}

div.#mainSection table tr
{
    vertical-align: top;
}

div.#mainSection table th
{
    text-align: left;
    background: #D8D8D8;
    border-bottom-color: #D8D8D8;
    border-bottom-style: solid;
    border-bottom-width: 1;
    color: #000000;
    padding-left: 5;
    padding-right: 5;
}

div.#mainSection table td
{
    background: #F2F2F2;
    border-top-color: #D8D8D8;
    border-top-style: solid;
    border-top-width: 1;
    padding-left: 5;
    padding-right: 5;
}

div.#mainSection table td.imageCell
{
    white-space: nowrap;
}

div.code
{
	width: 98%;
}

div.code table
{
    border: 0;
    font-size: 95%;
    margin-bottom: 5;
    width: 100%
}

div.code table th
{   
    text-align: left;
    background: #D8D8D8;
    border-bottom-color: #D8D8D8;
    border-bottom-style: solid;
    border-bottom-width: 1;
    color: #000000;
    font-weight: bold;
    padding-left: 5;
    padding-right: 5;
}

div.code table td
{
    background: #CCCCCC;
    border-top-color: #D8D8D8;
    border-top-style: solid;
    border-top-width: 1;
    padding-left: 5;
    padding-right: 5;
    padding-top: 5;
}

div.alert
{
	margin-left: 10;
	width: 98%;
}

div.alert table
{
    border: 1;
    font-size: 100%;
    width:  100%;
    border: solid 1 #DEDFEF;
}

div.alert table th
{
    text-align: left;
    background: #D8D8D8;
    border-bottom-width: 0;
    color: #000000;
    padding-left: 5;
    padding-right: 5;
    border: solid 1 #DEDFEF;
}

div.alert table td
{
    background: #FFFFFF;
    border-top-color: #D8D8D8;
    border-top-style: solid;
    border-top-width: 1;
    padding-left: 5;
    padding-right: 5;
    border: solid 1 #DEDFEF;
}

span.copyCode
{
    color: #0000ff;
    font-size: 90%;
    font-weight: normal;
    cursor: hand;
    float: right;
    display: inline;
    text-align: right;
}

.downloadCode
{
    color: #0000ff;
    font-size: 90%;
    font-weight: normal;
    cursor: hand;
}

.viewCode
{
    color: #0000ff;
    font-size: 90%;
    font-weight: normal;
    cursor: hand;
}

div.code pre
{
    font-family:    Monospace, Courier New, Courier;
    font-size: 105%;
    color:  #000000;
}

code
{
    font-family:    Monospace, Courier New, Courier;
    font-size: 105%;
    color:  #000000;
}

dl
{
    margin-top: 0;
    padding-left:   1;
}

dd
{
    margin-bottom:  0;
    margin-left:    0;
    padding-left:   20;
}

dd p
{
    margin-top: 5;
}

ul
{
    margin-left: 17;
    list-style-type: disc;
}

ul ul
{
    margin-bottom: 4;
    margin-left: 17;
    margin-top: 3;
    list-style-type: disc;
}

ol
{
    margin-left: 24;
    list-style-type: decimal;
}

ol ol
{
    margin-left: 24;
    margin-top: 3;
    list-style-type: lower-alpha;
}

li
{
    margin-top: 0;
    margin-bottom: 0;
    padding-bottom: 0;
    padding-top: 0;
    margin-left: 5;
}

p
{
    margin-bottom: 15;
}

.tip
{
    color:  #0000FF;
    font-style: italic;
    cursor:hand;
    text-decoration:underline;
}

.math
{
    font-family: Times New Roman;
    font-size: 125%
}
.sourceCodeList
{
    font-family: Verdana;
    font-size: 90%; 
}

pre.viewCode
{
    width: 100%;
    overflow: auto;
}

li:hover table, li.over table
{
    background-color: #C0C0C0;
}

li:hover ul, li.over ul
{ 
    background-color: #d2d2d2;
    border: 1px solid #000;
    display: block;
}

</style>
  </head>
  <body>
    
    <div id="header">
      <table width="100%" id="topTable">
        <tr>
          <td align="left">
            <span id="nsrTitle">Microsoft Exchange Web Services Managed API Release Candidate Readme</span>
          </td>
          <td align="right">
            <span id="headfb" class="feedbackhead">
            </span>
          </td>
        </tr>
        <tr id="headerTableRow3">
          <td />
          <td align="right">
          </td>
        </tr>
      </table>
      </div>
    <div id="mainSection">
      <div id="mainBody">

        <font color="DarkGray"> </font><p /> 
        <span id="changeHistory"></span>
        <p>
        <!-- DocStudio metadata -->
        <i><b>Topic Last Modified: </b>2008-12-11</i><br/>
	</p>
    <p>© 2009 Microsoft Corporation, All Rights Reserved.</p>
    <p>This Release Candidate version of the Microsoft Exchange Web Services (EWS) Managed API provides a new Microsoft .NET interface to the Exchange Server 2007 SP1 Web services and Exchange Server 2010 Web services. You can use this version of the EWS Managed API to evaluate the library for your application needs, and to compare it to directly using XML or the automatically generated proxy library that you might now be using.</p>
    <div class="alert"><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Important: </th></tr><tr><td>
      The assembly that is provided in this Release Candidate is not licensed for redistribution, and is not supported in an Exchange production environment.
    </td></tr></table></div>
    <p>This Readme provides information about how to provide comments and get support, information about installation prerequisites, and information about how to install and remove the EWS Managed API assembly and related documents. The document <i>Getting Started with the EWS Managed API</i> contains more information to help you use the EWS Managed API. The document is installed in the same folder in which the assembly is installed.</p>
  <h1 class="heading" expandcollapse="expand">Feedback</h1><div id="sectionSection0" class="section" style=""><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      The Exchange team welcomes feedback about the Exchange Web Services Managed API Release Candidate. You can submit feedback to the <a href="http://go.microsoft.com/fwlink/?LinkId=137093" alt="" target="_blank" xmlns=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">Exchange Server Development forum</linkText></a>. Feedback from our customers is an important part of our development process. Thank you for helping us to develop a better product.
      <p xmlns="">For online documentation, see <a href="http://go.microsoft.com/fwlink/?LinkId=132818" alt="" target="_blank"><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">Exchange Web Services Managed API Reference</linkText></a>. There you can find documentation, sample code, and other information to help you use the Exchange Web Services Managed API.</p>
      <p xmlns="">The <a href="http://go.microsoft.com/fwlink/?linkid=81" alt="" target="_blank"><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">Microsoft Exchange Server</linkText></a> Web site provides product and licensing information for Exchange Server, including white papers, product literature, Exchange-related events, service packs, and more. Visit the site frequently for new and updated content.</p>
      <p xmlns="">The<a href="http://go.microsoft.com/fwlink/?linkid=79434" alt="" target="_blank"><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5"> Microsoft Exchange Server Developer Center</linkText></a> Web site on MSDN includes news, additional development information, downloads, technical articles, newsgroups, and more. Visit the Microsoft Exchange Server Developer Center frequently for new and updated developer information.</p>
      <p xmlns="">The <a href="http://go.microsoft.com/fwlink/?linkid=34165" alt="" target="_blank"><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">Microsoft Exchange Server TechCenter</linkText></a> is your one-stop source for technical documentation about Exchange Server. The library is a catalog of technical Exchange Server content that has been reviewed and approved by the Exchange Server product team at Microsoft.</p>
    </content></div><h1 class="heading" expandcollapse="expand">Prerequisites</h1><div id="sectionSection1" class="section" style=""><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      To use this version of the EWS Managed API, you must have the following installed on the computer where you build client applications:
      <ul xmlns=""><li>
          Microsoft Visual Studio .NET 2008 or later<br></br>
        </li><li>
          Microsoft .NET Framework version 3.5 or later<br></br>
        </li></ul>
      <p xmlns="">If you will be running applications that use the EWS Managed API on a different computer, you must have the .NET Framework version 3.5 installed on that computer. Most applications do not require Visual Studio to be installed on the client computer.</p>
      <p xmlns="">The EWS Managed API can be used to access information on computers that are running the following versions of Microsoft Exchange Server:</p>
      <ul xmlns=""><li>
          Exchange Server 2007 Service Pack 1<br></br>
        </li><li>
          Exchange Server 2010<br></br>
        </li></ul>
      <p xmlns="">The Exchange server on which the Client Access server role is installed must have Exchange Web Services enabled. If Exchange Web Services is disabled, the EWS Managed API cannot communicate with the server.</p>
      <p xmlns="">The assembly provided in this Release Candidate is not licensed for redistribution, and is not supported in a production Exchange environment.</p>
    </content></div><h1 class="heading" expandcollapse="expand">Installing the EWS Managed API Assembly</h1><div id="sectionSection2" class="section" style=""><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      
        To install the EWS Managed API assembly
        <ddue:steps><ol xmlns=""><li>
            <content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
              Download the EwsManagedApi.msi file and store it on your hard disk.
            </content>
          </li><li>
            <content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
              Run the EwsManagedApi.msi file and follow the instructions in the installation wizard. You must accept the terms of the license agreement to install the software.
            </content>
          </li></ol></ddue:steps>
      
      <p xmlns="">The default install path is C:\Program Files\Microsoft\Exchange\Web Services\1.0</p>
      <div class="alert" xmlns=""><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Important: </th></tr><tr><td>
        To improve the security of your application and Web site, limit access to the EWS Managed API from other potentially untrusted applications by not installing the EWS Managed API assembly in the Global Assembly Cache (GAC).
      </td></tr></table></div>
    </content><sections xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      <h3 class="subHeading" expandcollapse="expand" xmlns="">Files Installed</h3><div class="subSection" xmlns=""><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
          The following files are installed by EwsManagedApi.msi:
          <ul xmlns=""><li>
              
                <b>Microsoft.Exchange.WebServices.dll</b>   The signed .NET assembly that implements the EWS Managed API.<br></br>
            </li><li>
              
                <b>Microsoft.Exchange.WebServices.xml</b>   Provides a Visual Studio .NET IntelliSense file for the EWS Managed API.<br></br>
            </li><li>
              
                <b>GettingStarted.doc</b>   Provides additional help for and information about how to use the API.<br></br>
            </li><li>
              
                <b>License Terms.rtf </b>  Contains the license terms for using the EWS Managed API and documentation.<br></br>
            </li><li>
              
                <b>Readme.htm</b> <br></br>
            </li></ul>
        </content></div>
    </sections></div><h1 class="heading" expandcollapse="expand">Removing the EWS Client API Assembly</h1><div id="sectionSection3" class="section" style=""><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      To remove the EWS Managed API files from your computer, locate and run the EwsManagedApi.msi installer and select the <b xmlns="">Remove</b> option.
    </content></div><h1 class="heading" expandcollapse="expand">Known Issues</h1><div id="sectionSection4" class="section" style=""><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
      
        <b xmlns="">Preliminary release</b>   This Release Candidate version of the EWS Managed API is a preliminary release. The software is still in development, and for that reason might change in both major and minor ways before release. 
      <p xmlns="">
        <b>Not Redistributable</b>   This version of the EWS Managed API is provided for evaluation only. Do no distribute this API, the assembly, or any other files included in EwsManagedApi.msi installer. The assembly and associated other files are not licensed for redistribution.  See the license agreement for more specific information.</p>
      <p xmlns="">
        <b>Do Not Install into GAC</b>   To improve the security of your application and Web site, limit access to the EWS Managed API from other potentially untrusted applications by not installing the EWS Managed API assembly in the Global Assembly Cache (GAC).</p>
    </content></div><!--[if gte IE 5]>
			<tool:tip element="seeAlsoToolTip" avoidmouse="false"/><tool:tip element="languageFilterToolTip" avoidmouse="false"/><tool:tip element="roleInfoSpan" avoidmouse="false"/>
		<![endif]--></div>
      <div id="footer">
        
			
			
		</a>
 	
      </div>
    </div>
  </body>
</html>